<html>
	<head>
	</head>
	<body>
		<h1>URI Scheme for NS package</h1>
		<h2>URI Form</h2>
		<p>
			&lt;<strong>ns</strong>&gt;
			<em>&lt;resultion_operator&gt;:</em>
			&lt;<strong>path_element</strong>&gt;
			<em>[/&lt;path_element&gt;]</em>
		</p>
		<p>[ _-\w]*?[=:]{0-2}:([ _-\w]*?)(/[ _-\w]*?)*</p>
		<h2>Resultion Operator</h2>
		<p>There are serveral scope resultion operators if ommited (the standard) then = is assumed</p>
		<dl>
			<dt>= (=:)</dt>
			<dd>Match<a style="vertical-align: super; font-size: 0.7em;" href="#4">[4]</a>. The path segments point to a resource.</dd>
			<dt>: (::)</dt>
			<dd>Title Match. The first element matches a title in the namespace. If many titles match then a selection list will be shown</dd>
			<dt>:: (:::)</dt>
			<dd>Meta Match<a style="vertical-align: super; font-size: 0.7em;" href="#5">[5]</a>. The path segments point to a resource, but metadata is shown rather than the resouse.</dd>
		</dl>

		<h2>Predefined Namespaces</h2>

		<h3>about:</h3>
		<p>URIs in this namespace give data about the bitweaver installation and the ns package</p>
		<p style="font-size: 0.9em;">Note, this namespace only supports matches.</p>
		<h4>Specific URIs</h4>
		<dl>
			<dt>about:version</dt>
			<dd>Displays version information about bitweaver <a style="vertical-align: super; font-size: 0.7em;" href="#1">[1]</a></dd>
			<dt>about:ns</dt>
			<dd>Displays version information about ns package <a style="vertical-align: super; font-size: 0.7em;" href="#1">[1]</a></dd>
			<dt>about:phpinfo</dt>
			<dd>Displays the phpinfo page <a style="vertical-align: super; font-size: 0.7em;" href="#1">[1]</a></dd>
		</dl>
		<h3>uri:</h3>
		<p>URIs in this namespace are redirects to the non-namespace uri</p>
		<p style="font-size: 0.9em;">Note, this namespace only supports matches.</p>
		<h3>system:</h3>
		<p>The system namespace gives access to many of the bitweaver system menus and settings</p>
		<p style="font-size: 0.9em;">Note, this namespace only supports matches.</p>
		<h4>Specific URIs</h4>
		<dl>
			<dt>system:admin/....</dt>
			<dd>admin prefixed items access the adminstration menu</dd>
			<dt>system:config</dt>
			<dd>Fast access to the namespace configuration options</dd>
			<dt>system:</dt>
			<dd>Fast access to the namespace alocation settings</dd>
			<dt>system:ns/&lt;c_id&gt;</dt>
			<dd>Preforms a redirect to the namespace URI for the content id, or if none is alocated a LibertyContent redirect to the handling package</dd>
		</dl>
		<h3>search:</h3>
		<p>The search namespace is a standard interface to the search serivce. <a style="vertical-align: super; font-size: 0.7em;" href="#2">[2]</a></p>
		<p style="font-size: 0.9em;">Note, this namespace does not support metadata matches, and the title match operator is only supported with the form search::string, any other use will result in an error</p>
		<h4>Specific URIs</h4>
		<dl>
			<dt>search::string</dt>
			<dd>Returns a full site search for the string</dd>
			<dt>search:type/&lt;c_type&gt;/string</dt>
			<dd>Returns a full site search of the given content type matching the string</dd>
			<dt>search:cat/&lt;cat&gt;/string</dt>
			<dd>Returns a search of the given category for the string<a style="vertical-align: super; font-size: 0.7em;" href="#3">[3]</a></dd>
			<dt>search:cat/&lt;cat&gt;/type/&lt;c_type&gt;/string</dt>
			<dd>Returns a search of the given category for content of the given content type matching the string<a style="vertical-align: super; font-size: 0.7em;" href="#3">[3]</a></dd>
		</dl>
		<p style="font-size: 0.9em;">Note<a style="vertical-align: super; font-size: 0.7em;" name="2">[2]</a>, if there is no package enabled which supplies the search serivice all URIs in the search namespace will return an error stating that there is no search service.</p>
		<p style="font-size: 0.9em;">Note<a style="vertical-align: super; font-size: 0.7em;" name="3">[3]</a>, if there is no package enabled which supplies the categorization serivice all URIs that would preform category searches return an error stating that there is no categorization service.</p>
		<h3>ns: &amp; namespace:</h3>
		<p>The namespace &quot;ns&quot; and &quot;namespace&quot; are reserved for future use.</p>
		<h2>Security Issues</h2>
		<dl>
			<dt>about: <a style="vertical-align: super; font-size: 0.7em;" name="1">[1]</a></dt>
			<dd>The about pages are usually restricted to administrators, though the admin can relax this restriction</dd>
			<dt>Access Control <a style="vertical-align: super; font-size: 0.7em;" name="4">[4]</a></dt>
			<dd>Content is passed though normal access control methods, so users can't access content they would not otherwise have had access to.</dd>
			<dt>Metadata Access <a style="vertical-align: super; font-size: 0.7em;" name="5">[5]</a></dt>
			<dd>The Metadata that is shown to ordinary users is limited. Users with the p_ns_extended_meta permision will be shown extended metadata. The Administrator has the option to require the p_ns_extended_meta for all metadata access.</dd>
		</dl>
	</body>
</html>